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If NDF ,PRMSW FOR LINKAGE WITH SYS.EXE,... 
STITLE SYSLOAVEC = SYSTEM VECTORS TO LOADABLE SUBROUTINES 

oIFF FOR LINKAGE WITH SYSLOAxxx.EXE,... 
ofA TtE LOAVEC = OFFSETS TO LOADABLE SUBROUTINES 


-IDENT ‘V04-000' 


| eunneeeuenegdonennenbebeesneennenennetensaennseenesencooeesneneeeeseeeneeene 


COPYRIGHT (c) 1978, 1980, 1982, 1984 B 
DIGITAL EQUIPMENT CORPORATION, MAYNARD. MASSACHUSETTS. 
ALL RIGHTS RESERVED. 


ab a a te kt 


NOAA WN 9 O OO NAUE WN SO OD NAME WIN O OD NAU EWN @ OOD NOAU EW OWONOA UNSW 


® * 
;® ® 
st * 
:* * 
sa ® 
:* * 
sf « 
:® a 
:® I * 
;@ PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY * 
;* TRANSFERRED. ° 
sf ® 
;® THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE * 
;* AND SHOULD NOT * 
sf * 
sf * 
st * 
ft * 
sf * 
st ® 
sf * 


BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT 
CORPORATION. 


DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR _ RELIABILITY OF ITS 


OOOO oOQCQOQOOooOoOoooOooooooooS 


SoOSOOCSSSOoOSCOOSOSOSOSOSOSOOSOSOSOOSOOOO 


OOOOCOOSCOOSSSOSOSSOSOOSOOOOOOOOOOOOOOOOOOOO 


SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 


LARARARALARAAAALALAAAAAA SLA RLALESALASALES ESAS ASSL SEES EERE EARS RAR RARER RARE SS 


+ 
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Add EXESMNTVER vi “ASSIST. an escape transfer vector which 
allows $GETDVI~ support for shadow sets to be shipped with 
mount verfication in SYSLOAxxx. 


v03-020 wWHM0001 Bill Matthews 09-Jul-1984 
Added vectors for routines CONSINIT_CTY, CONSGET CHAR and CONSPUTCHAR 


0 
0 
0 
0 
0 
0 
00 FACILITY: 
00 EXECUTIVE, LOADABLE SUBROUTINES 
900 ; ABSTRACT: 
$00 41 : VECTORS, LOAD IMAGE SIZE, AND UNDEFINED VECTOR HANDLER FOR 
00 4 LOADABLE SUBROUTINES. 
4 2 AUTHOR: 
4 N. KRONENBERG, MARCH 13, 1979. 
4 MODIFIED BY: 
v03-021 ROW0407 Ralph 0. Weber 25-JUL-1984 


SOooooooooooo 
ooo 


| 
| 
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SOOooooo 
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HE 


ao 


—— —§ § ~ODODODOO0SO000OO0O OOO O09 09 69 09 09 09 09 G9 09 09 SIN NN SIN NIN NNO OAOAOAO 
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a at a a ts 


v03-019 caweoee Ralph 0. Weber 7=JUL-1984 
Gee d the fo f Ltowing” transfer or " pointer vectors for Mount 


) AUST Bata, v VAXcluster state transition 1/0 block. 


o EXES update shadow set generation number. 
o EXESGL OmVASLBAS, VMSL base address. 
v03-018 TCMO003 rudy C. Matthews 09-Apr-1984 
Add vector for pootiie CONSRELEASECTY. 
v03-017 owes Ralph 0. Webe 24-MAR=-1984 
‘= — apunt’ verification transfer vectors for possible 
— volume shadow! ng. 
v03-016 KPLOOO1 Peter Lieberwirth r-1984 
Add some extra vectors (aligned and eosheds "ies possible 
use in 4.x. 
v03-015 ROW0317 Ralph 0. Weber 27-F EB-1984 


Correct patch area descriptor to have patch size in bytes not 
in longwords. 


V03-014 ROW0292 Ralph 0. Weber 4-FEB-1984 

Add three vectors for ooynt verification, which is being moved 

2 SYSLOAxxx: EXESMOUNTVER the main entry point, + aga VERSIO 
9) to the start 170 routine for mount verification, and 

EXES NIVERSHDOL entry point to the oring shadow unit online 

routine (which does not exist yet). SMNTVERSIO allows 

in-driver mount verification routines t to use a standar 

interface to starting and completin = internal 1/0 re uest. 


EXESMNTVERSHDOL is provided for T to use when it brings 
the members of a shadow set online patie cen 
v03-013 CWH8001 Dec-1983 


Add EXESREADP_ ToDR and "EXESURITEP, TODR Ae «ety used to 
reree access Of physical TODR on Nautilus CPU. On other 

these routines are second Labels on EXESREAD_ TODR "ond 
EXESURITE® TODR. 


v03-012 KDM0062 Kathleen D. Morse 19-Jul-1983 
Add routine to initialize the time-wait macro data 
cells, EXESINI_TIMWAIT. 

v03-011 KTAO0O1 Kerb Ay . Altmann 12-Jul-1983 
Add routine for console gey'ce data structure 
initialization, INISCONSO 


v03-010 KDM0057 Kathleen D. Morse 12-Jul-1983 
Change the SYSINIT fauzion SIP SSETTINE, to : loadable, 
cpu-dependent routine, EXESINIT-TODR. 


v03-009 konopss Kathleen D. Morse 07-Jun-1983 
Add loadable routines for referencing TODR: 
EXESREAD_TODR and EXESWRITE_TODR. 


v03-008 wac0001 Wayne Cardoza 09-Jun-1983 
Add loadable code system service dispatchers. 


” 
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a st a ts te a ts 2 i a ee 
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Sooooooooocoo 
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V03-007 JwHO203 Jeffrey W. Horn 22-Mar-1983 
Use SLVTAB macro to set up loadable-image header. 

v03-006 TCM0002 Trudy C. Matthews 16-Feb-1983 
Add CONSOWNCTY vector. 

v03-005 TCMO0001 udy C. Matthews 13-Jan-1983 


Add SYSLSCLRSBIA yy point. Add an alternative default 
routine that RSBs harmlessly. if called before code is 
loaded, instead of halting. 


V03-004 KTA3018 Kerbey T. Altmann 30-0c t-1982 
Redo to reflect changes in modules. 
v03-003 MSHO001 $30380" Hinden 24-Sep-1982 
Change entry EXESDW/80_INT to EXESUBAERR_INT. 
V03-002 $TJ3026 Steven T. Jeftreys 24-Sep-1982 
ee LOADVEC macro to SYSMA 
v03-001 BLS0183 Benn Schreiber 16-Aug-1982 


Add new entry points for loadable console support 
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bee ti aes 84:88:15 iG SYS. SRCISYSLOAVEC.MAR; 1 - (3) 
+ 
THIS MODULE MAY BE ASSENB LeD WITH EXECUTIVE MODULE PRMSW.MAR 
WHICH DEFINES TH ONL TTD CONT OL VARIABLE PRMSW. IF PRMSW 
1S NOT DEFINED N SY SLOAY C.MAR IS INTENDED TO LINK WITH SYS.EXE. 
IF PRMSW IS DEFINED. SYS OAV C:MAR IS INTENDED FOR LINKAGE WITH 
SYSLOAxxx.EXE. (xxx IS CPU DISIGNATOR, E.G., 780.) 
IF PRMSW IS NOT DEFINED (LINK WITH SYS.EXE), THE SOURCE CONTAINS 
A LIST OF VECTORS TO BE CONNECTED TO THE SUROUTINES AND DATA STRUCTURES 
IN SYSLOAxxx.EXE. 
DATA VECTORS ARE LONGWORD PO 


vy ty TO THE LOADED DATA STRUCTURES. BEFORE 
LOADING, THE POINTES CONTAIN A 0. 


SUBROUTINE VECTORS ARE OF THE FORM: 

ENTRY:: JMP @#EXESLOAD_ERROR 

THERE ARE TWO TYPES OF ROUTINE ENTRIES. THE FIRST TYPE IS LONGWORD 
ALIGNED ENTRIES FOR SCB VECTORS. THE SECOND TYPE IS PACKED 

ENTRIES FOR ORDINARY ROUTINES. 


SYSLOAVEC me COMTALNS bh - ERROR HANDLER, EXESLOAD_ERROR, 
WHICH IS SIMPLY A HALT. IF LOADABLE SUBROUTINE IS CALLED 


WN SO OOO NOA UNE OC OO NAN E — 


sb = — = = — 2 = a — > os 1 — ss 1s as + a as a a 


5 ; PRIOR TO BEING. LOADED, THE HALT WILL BE EXECUTED. 

5 ; IF PRMSW IS DEFINED (LINK WITH ad grt EXE), THE SOURCE 

3 ; CONTAINS LOAGWORD EXESL Se Satie HE NUMBER OF BYTES IN SYSLOAxxx.EXE. 
THE a aby ALSO CONTAINS A LIST OF be SELF-RELATIVE OFFSETS TO 

Q ; THE SUBROUTINES IN SYSLOAxxx.EXE. LIST OF OFFSETS IS USED 

} TO CONNECT THE SYS.EXE VECTORS TO THE LOADED SUBROUTINES. 
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-SEP-1 SYS.SRCISYSLOAVEC.MAR;1 
174; 
178 : MISC. LABELS AND DATA: 
178 ? 
178 If DF ,PRMSW FOR LINKAGE WITH SYSLOAxxx.EXE,... 
: 9 SDYNDEF 
1 ¢ -PSECT __LOAD_END,QUAD ; Force Label to be at the end of 
! Z SYSLSEND:: ; loadable code 
8 185 -PSECT $$$000 ; Force return to start of loadable code 
1 $ SYSLSBEGIN:: 
0 1 SLVTAB END = SYSLSEND, - 
1 } INITRTN = INISIOMAP, = 
0 ; FACILITY= <SYSLOAVEC> 
0 5 191 : NOTE: The modules, INIADPxxx, understand how to unload the vectors 
00 136 3 for routines that are only called once our ine initialization 
00 193 ; of the system. Therefore, if the format of these vectors 
44 130 : change, then the code in {NIADPxxx must also change. 
000 196 © 
$00 199 
at 138 ~ IFF ; For Linkage with SYS.EXE,... 
0000000 19 -PSECT $$$500,LONG ; 
i 00 -ALIGN LONG ; Start vector List on longwd 
00 01 EXESAL_LOAVEC:: ; Addr of start of vectors 
0000 308 ee 
0000 04 
0000 05 ; 
44 6 ; VECTOR LIST: 
0000 4 3 Define longword-aligned routine vectors. 
00 09 ° 
itd 10 LOADVEC EXESMCHK, TYPE=2 ;MACHINE CHECK HANDLER 
Bode 11 LOADVEC EXESINT54, TYPE= ; INTERRUPT, SCB VECTOR=*x54 
3 E \¢ LOADVEC EXESINTS8, TYPE= s INTERRUPT, SCB VECTOR=*X58 
16 1 LOADVEC EXESINT Bhs je z INT - SCB VECTOR=*X5C 
th 14 LOADVEC EXESINT60,1YPE= s INTERRUPT, SCB VECTOR=*x60 
0 15 LOADVEC UBASUNEXINT,TYPE=2, - ; INTERRUPT, UNIBUS ITSELF 
? 18 SEC_LABEL=UBA_UNEXINT 
6 E H : Extra aligned vectors. Current target of these vectors in SYSLOA is a 
: 4s 3 halt instruction in ERRSUB*. 
; . LOADVEC EXESEXTRA1, TYPE= ZEXTRA LABEL 
§ LOADVEC EXESEXTRA2, TYPE= sEXTRA LABEL 
. LOADVEC EXESEXTRAS, TYPE= EXTRA LABEL 
4 4 LOADVEC EXESEXTRA4, TYPE= EXTRA LABEL 
36 5 LOADVEC EXESEXTRAS, TYPE= sEXTRA LABEL 
3 : Define packed routine vectors. 
0 LOADVEC ECCSREENABLE sMEMORY ERROR TIMERS 


$< 
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502000 -$ ett 83:88:15 SYS.SRCIJSYSLOAVEC.MAR;1 ve (3) 
5 1 LOADVEC EXESINIBOOTADP : INIT BOOT DEVICE ADAPTER 
és § LOADVEC EX sd old ;DUMP CPU-SPECIFIC IPR'S INTO EMB 
aed XESREGRESTOR RESTORE CPU-SPECIFIC JPR 
of 4 LOADVEC EX she SAVE sSAVE CPUSSPECIFIC IPR'S 
5 LOADVEC EXESINIPROCREG sINIT PROCESSOR REGISTERS 
7A § LOADVEC aeerest CSR ; TEST UB CSR FOR EXISTENCE 
? LOADVEC IOCSPURGBATAP rt 3 DATAPATH 
8 LOADVEC INISMPMADP sINITIALIZE MULTIPORT MEMORY 
LOADVEC EX ate 4 ;Startup up any adapters 
40 LOADVEC EXESSHUTDWNADP sShutdown any (all) adapters 
9 41 OADVEC MASRAVAI sMultiport memory 
9 tg yt te ds rest yaa pH sMultiport memory request 
A 4 LOADVEC MA {ut AL sMultiport initialization 
AA 44 LOADVEC CONSSTARTIO iConsote start 1/0 
BO 45 LOADVEC CONSSET_LINE sSet Line 
086 $8 LOADVEC CONS$DS_SET Data set 
0B 4 LOADVEC CONSXOR 7X0N to console 
OC 48 LOADVEC CONSXOFF sXOFF to console 
OC 49 LOADVEC CONSSTOP ;STOP output 
OOCE 50 LOADVEC CONSSTOP2 stop for 3 seconds 
sie 51 LOADVEC CONSABORT zsAbort console 1/0 
ODA 26 LOADVEC CONSRESUME ;Resume output 
0E0 5 LOADVEC CONSSET_MODEM :Set modem 
bee 54 LOADVEC CONSNUL zNull routine 
E 55 LOADVEC CONSDISCONNECT sConsole disconnect routine 
OOF 56 LOADVEC CONSINITIAL sInitialize console controller 
OOF 2 LOADVEC CONSINITLINE sInitialize console Line 
OOFE 8 LOADVEC CONSINTINP zsInput interrupt 
Ht 59 LOADVEC CONSINTOUT sOutput interrupt 
10A 60 LOADVEC CONSSENDCONSCMD :Send cpu-dependent command to console 
118 61 LOADVEC SYSLSCLRSBIA, - :Clear SBIA error bits 
11 $6 DEF _RTN=EXESLOAD_NOP 
116 § LOADVEC CONSOWNCTY Set up to talk directly to console tty 
11 64 LOADVEC CONSRELEASECTY ;Restore normal console cty interface 
4 65 LOADVEC CONSGETCHAR :Get a character from the console cty 
1 66 LOADVEC CONSPUTCHAR ;Put a character out to the console cty 
012E 67 LOADVEC CONSINIT_CTY Initialization routine for the console cty 
134 68 LOADVEC EXESREAD TODR Read Time-Of-Day Register 
13A 69 LOADVEC EXESWRITE_TODR sWrite Time-Of-Day Register 
140 70 LOADVEE EXESINIT TODR sInitialize system time-of-da 
146 71 LOADVEC INISCONSOLE zsInitialize console device data struc 
14 i LOADVEC EXESINI_TIMWAIT sInitialize time-wait loop data cells 
15 7 LOADVEC EXESREADP_TODR Read physical TODR register 
iF 74 LOADVEC pxesun tte TODR iWrite p ys al TOOR register 
15E 75 LOADVEC EXESMOUNTVER Mount verification main entry point 
164 7 LOADVEC EXESMNTVERSIO sMount verification start 1/0 request 
19A 7 LOADVEC EXESMNTVERSHDOL zsMount verification online shadow unit 
170 7 LOADVEC EXESCLUTRANIO sMount verification VAXcluster state 
178 7 3. transition piece 1/0 
17 0 LOADVEC EXESUPDGNERNUM sMount verification update shadow set 
17C¢ 1 3 generation number 
17 ‘ LOADVEC EXESMNTVER py! ASSIST Mount verification SGETDVI escape 
1 LOADVEC EXESMNTVERSP sMount verification spare xfer vector 
1 4 LOADVEC EXESMNTVERSP2 sMount verification spare xfer vector 
18E 5 LOADVEC EXESGL_MVMSLBAS, 1., - ;Mount verification MVMSL base address 
E 6 EXESAB_MVMSLBAS 
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; Extra packed yoct rs. Current target of these vectors in SYSLOA is a 
3; halt instruction in ERRSUB*. 


LOADVEC NESE RTRAG EXTRA LABEL 
LOADVEC tty th sEXTRA LABEL 
LOADVEC EXESEXT ~ sEXTRA LABEL 
LOADVEC EXESEXTRA sEXTRA LABEL 
LOADVEC EXESEXTRA10 sEXTRA LABEL 


Define pointers to data stuctures. 


LOADVEC EXESMCHK_ERRCNT,TYPE=1 ;Point to array of mchk error counters. 


IF DF ,PRMSW ; For the loadable image 
sLOne -1 ; put in a stopper signal 


LINKAGE WITH SYS.EXE, DEF A LOAD ERROR HANDLER AND A HANDLER THAT 


IF LI INE 
22 totes (FOR A ROUTINE USED BY XDELTA THAT MAY BE CALLED BEFORE 


DS DS \ PS OO0000 000069 09 G9 G9 C9 GO GO GO OO OOOONHMIMPININPVINVINIO HO Pb FL 


1 
1 
: 
1 $3 
1A 9 
1A 94 
1A 95 
18 38 
18 9 
1B 38 
1B 9 
18 , 
i 
168 808 
18 4 
18 5 
18 $ 
188 30 
1B8 309 
18 10 NG LOADED) 
uae 
18 1 
18 14 olf NDF ,PRMSW 
00 1 1? EXESLOAD_ERROR:: et a CALL TO UNLOADED 
18 i$ EXESLOAD_NOP:: ;COME HERE IF ROUTINE NOT LOADED 
05 1B 8 RsB ; BUT DON'T WANT TO ERROR HALT 
H 3 ~ENDC 
1B 1 3 
O18 § ; IF LINKAGE WITH SYS.EXE, DEFINE THE DIPATCH VECTOR FOR LOADABLE CODE 
1BA 3; SYSTEM SERVICE DISPATCHERS. THERE ARE SEPARATE VECTORS FOR EXEC AND 
184 : 3; KERNEL MODE WITH TWO SPARE ENTRIES IN EACH. 
1BA § 
1a olf NDF ,PRMSW 
1BA 5 EXESLOAD_KDISP:: Kernel mode dispatchers 
1BA O EXESLOAD KCJF:: 
000001B9°9F 16 O1BA 1 SB @#EXESLOAD_NOP 3CJUF 
i¢8 § EXESLOAD_KRUF:: 
00000189 ' 9F 16 1¢ @#EXESLOAD_NOP ; RUF 
19 4 EXESLOAD_KSPR1:: 
00000189 ° 9F 16 1¢ 5 @#EXESLOAD_NOP sFirst spare 
1¢€C § EXESLOAD_KSPR2:: 
00000189 ' 9F i ic : 738 @#EXESLOAD_NOP Second spare 
1D 
1D rt EXESLOAD_EDISP:: zsExec mode dispatchers 
1D 41 EXESLOAD ESPR1:: 
000001B89'9F 16 01D 5 SB @#E XESLOAD_NOP iFirst spare 
1D 435 EXESLOAD_ESPR2:: 
00000189°9F 16 01D9 44 JSB @#EXESLOAD_NOP Second spare 


SYSLOAVEC 
v04= 


m9 
= SYSTEM VECTORS TO LOADABLE SUBROUTINES i a i ae 9 03:98:13 y 


AX/VMS Macro V04-00 
SYS.SRCIJSYSLOAVEC .MAR; 1 


05 IDF i RSB 
iE 4 END 
6) $48 a 
IE 1 ; IF LINKAGE WITH SYSLOAxxx.EXE, DEFINE 15 LONGWORDS OF PATCH AREA: 
iE : 
1£ 2g IF DF ,PRMSW 
1€ 54 -PSECT _PATCH 
1E 55 PATCH_DESC: : 
1E 36 .LONG 15%4 
1E “LONG PATCH_AREA 
1E 28 PATCH_AREA:: 
1E 5 -BLKL 15 
1E 60 ENDC 
160 361 
160 362 END 
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CSPURGDATAP 
MASINITIAL 
MASRAVAIL 
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MASREQUEST 
SYSLSCLRSBI 
UBASUNEX INT 
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Psect synopsis 
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Psect s 


: ynopsis ! 
mmm ee oe mem oaa we > 
PSECT name Ailocation PSECT No. Attributes 
“o-. SAC 00000000 » 0 ¢ QO.) NOPIC USR CON ABS LCL NO 
$$$500 QOOOOIEO ¢ 480.) $f ( 1.) NOPIC USR CON’ REL LCL NO 
¢wececeeos Se ws ee wane a $ 
; Performance indicators ! 
Phase Page faults CPU Time Elapsed Time 
Initialization 35 0:00: 8-19 8 :00:01.49 
—“y pees 183 09:00: 8°34 00:00;16.05 
Symbol table sort 9 00:00: 0:66 $0;00:08:06 
Pass 2 8 00:00:01. 00:00:05.18 
Symbol table output 10 as SO 88:80: 8065 
Psect synopsis output 5 00:00: 3° Os 0:00:00.02 
Cross-reference output 00:00:00.0 00:00:00.00 
Assembler run totals 411 00:00:07.67 00:00:28.34 


The working set Limit was 1200 pages. 

25770 bytes (51 pages) of virtual memory were used to buffer the intermediate code. 

There were 10 pages of symbol table space allocated to hold 81 non-local and 0 local symbols. 

362 source Lines were read in Pass 1, produc Sng 15 object records in Pass 2 

2 pages of virtual memory were used to define | macro. 
ee 


Macro Library name 
.$255$DUA28:CSYS.OBJJLIB.MLB; 1 

$255$DUA28: (SYSLIBJSTARLET.MLB; 2 
TOTALS (all Libraries) 


58 GETS were required to define 1 macros. 


There were no errors, warnings or information messages. 
MACRO/LIS=L1S$:SYSLOAVEC/OBJ=OBJ$:SYSLOAVEC MSRC$:SYSLOAVEC/UPDATE=(ENHS:SYSLOAVEC) +EXECML$/LIB 
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SYS.SRCISYSLOAVEC.MAR; 1 (2) vO 
SHR NOEXE NORD NOWRT NOVEC RYTE 
SHR EXE RD WRT NOVEC LONG 

Paths No a 
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